{% extends "help/index.html" %} 
{% block content %}

<h2>Export XML Tab</h2>
<table class="gs-nav"><tr>
  <td><a href="/help/dataviewertab">&lt; Data Viewer Tab</a></td>
  <td style="text-align: center"><a href="/help/">Index</a></td>
  <td style="text-align: right">&nbsp;</td>
</tr></table>

<p>Once you have worked with OpenSocial code in the Code Tab, you will
  likely want to create an XML specification that can be installed as a
  standalone app.  The "Export XML" tab lets you create OpenSocial gadget
  specifications easily, without needing to write XML by hand.</p>

<img src="http://osda.appspot.com/img/exporttab_1.png" class="center" />

<p>Just like the Code Tab, you can save and load data from the Export XML Tab.
  This way, you can generate a standard sample template, and quickly export 
  different gadget samples using most of the same settings.</p>
  
<ol>
  <li value="1"><span>Here is the list of XML specs that you have 
    saved.</span></li>
  <li value="2"><span>Press the "Load" button to load the currently selected
    XML spec.</span></li>
  <li value="3"><span>Press the "Save XML spec as" button to save the current
    contents of the export form.</span></li>
  <li value="4"><span>Fields in the form correspond with the structure of the
    gadget XML specification.</span></li>
</ol>

<img src="http://osda.appspot.com/img/exporttab_2.png" class="center" />

<ol>
  <li value="5"><span>Check the box next to feature names you want to include
    in your exported gadget.  Once a feature is included, you may select 
    whether to specify the feature as required or optional.</span></li>
</ol>

<img src="http://osda.appspot.com/img/exporttab_3.png" class="center" />

<ol>
  <li value="6"><span>You may specify Preload elements using the 
    "Add a preload element" button.</span></li>
  <li value="7"><span>Once you have added a Preload, enter its URL in the 
    long textbox.</span></li>
  <li value="8"><span>Choose the type of authentication in the 
    Preload.</span></li>
  <li value="9"><span>For signed requests, you may specify whether to sign the 
    viewer or the owner.</span></li>
</ol>

<img src="http://osda.appspot.com/img/exporttab_4.png" class="center" />

<p>The Export XML tag supports multiple views.  By default, it adds a "canvas" view.</p>

<ol>
  <li value="10"><span>Click the "Add a view" button to add another content 
    section.</span></li>
  <li value="11"><span>You can switch between content sections by clicking the
    name of its section in this row of tabs.</span></li>
  <li value="12"><span>If you want to change the name of the current view,
    edit the value in this field.</span></li>
  <li value="13"><span>If you want to use the current contents of the Code 
    Tab's textbox, click the "Copy from code tab" button to insert it into the
    current view's content section.</span></li>
  <li value="14"><span>Unlike the Code Tab, the content sections in the
    Export XML Tab support both HTML and JavaScript.  JavaScript code must
    be inserted between &lt;script&gt; tags, like you would in an HTML
    document.  For convenience, JavaScript code is highlighted in this view.
    </span></li>
</ol>

<img src="http://osda.appspot.com/img/exporttab_5.png" class="center" />

<ol>
  <li value="15"><span>When you are ready to export the contents of this 
    form, press the "Export" button.</span></li>
  <li value="16"><span>An overlay pops up containing the rendered XML
    specification.  Currently, to save this file to a web server you must copy 
    and paste it into a text file on your computer, then upload it manually
    to your server.</span></li>
</ol>

<table class="gs-nav bottom"><tr>
  <td><a href="/help/dataviewertab">&lt; Data Viewer Tab</a></td>
  <td style="text-align: center"><a href="/help/">Index</a></td>
  <td style="text-align: right">&nbsp;</td>
</tr></table>

{% endblock %}